home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / SICE-DOC.ZIP / README.SI < prev    next >
Text File  |  1992-03-23  |  13KB  |  271 lines
  1.      List of sections within this file:
  2.  
  3.       1. INSTALLING SOFT-ICE
  4.       2. INSTALLING WITH DOS 5
  5.       3. PATCH TO SOFT-ICE TO RUN MAGIC    CV WITH    CODEVIEW 3.14
  6.       4. BATCH FILES FOR COMPILING WITH    MICROSOFT C COMPILERS
  7.       5. BATCH FILES FOR COMPILING WITH    BORLAND    C++ COMPILERS
  8.       6. BATCH FILE FOR    COMPILING WITH BORLAND TURBO PASCAL
  9.       7. CONFIG    EDIT
  10.       8. MSYM WARNINGS
  11.       9. COMPILING WITH    TOPSPEED
  12.       10. BPAND    PROBLEM
  13.  
  14.       -------------------------------------------------------------------
  15.       1. INSTALLING SOFT-ICE
  16.       -------------------------------------------------------------------
  17.     When Soft-ICE is copied    to a system, EMMSETUP should be    run to 
  18.       insure that the internal EMM map within S-ICE.EXE    matches    the con-
  19.       figuration of that system. When running EMMSETUP,    first select 
  20.       "Reconfigure Driver to Current Configuration". If    you have any I/O 
  21.       adapters which use memory, such as network cards,    select "Manual 
  22.       Configuration and    Status Screen" and X-out the block of memory 
  23.       used. After exiting EMMSETUP, check the date and time on S-ICE.EXE 
  24.       to insure    that it    has been changed.
  25.  
  26.      When Soft-ICE is installed in the CONFIG.SYS file, the    switches 
  27.       are assigned as follows:
  28.     /EXT reserves XMS memory from the 1Mb boundary on up for drivers 
  29.       such as HIMEM, CACHE, SMARTDRV and RAMDRIVE. HIMEM.SYS uses 64K of 
  30.       XMS memory, and the others use the amount    specified in their 
  31.       switches.    Add these up and set the EXT switch to this total.
  32.     /SYM reserves space to store the symbolic debug    data and the 
  33.       source files. The    amount needed depends on the user's application, 
  34.       but usually the largest portion is for storing the source    files. 
  35.       This space is in extended    memory,    just below Soft-ICE (which is at 
  36.       the top of extended memory). In many cases a large amount    of SYM 
  37.       space is necessary. 
  38.     /EMM reserves space for    use as emulated    expanded memory. It is 
  39.       used by SMARTDRV and RAMDRIVE with the /A    switch,    and sometimes by 
  40.       application programs. On some systems, CodeView 3.11 and 3.14 will 
  41.       run only in expanded memory. This    space is reserved just below the 
  42.       /SYM space.
  43.  
  44.       -------------------------------------------------------------------
  45.       2. INSTALLING WITH DOS 5
  46.       -------------------------------------------------------------------
  47.      S-ICE.EXE must    be used    as the EMS memory manager (do not use 
  48.       EMM386).
  49.      HIMEM.SYS must    be after S-ICE.EXE, not    before.    When HIMEM.SYS is
  50.       loaded, it displays the message "Installed A20 Handler" followed by
  51.       a    number.    If the number is not "1" or "2", you must use the switch 
  52.       "/m:1" with HIMEM.SYS.
  53.      DOS 5.0 may be    loaded high with the "dos = high" command. Note    
  54.       that HIMEM.SYS must be installed to use this.
  55.      If you    wish to    load drivers and T&SR's high, you must configure 
  56.       S-ICE.EXE    for this using EMMSETUP.
  57.      If you    do not have our    utility    UMB.SYS, you must use our Load 
  58.       High utilities (LD.SYS and LH.EXE). Since    the DOS    5.0 load high 
  59.       utility is called    by "LH", rename    ours to    LHIGH.EXE or specify the 
  60.       full path    to LH.EXE. You cannot use "dos = umb". Your CONFIG.SYS 
  61.       file should look something like this:
  62.  
  63.           dos = high
  64.           device = c:\si\ce.exe          ;configuration editor
  65.           device = c:\si\s-ice.exe /SYM 500    /EXT 2112 /EMM
  66.           device = c:\dos\himem.sys    /m:1
  67.           device = c:\si\ld.sys c:\ansi.sys
  68.           device = c:\si\ld.sys c:\dos\smartdrv.sys    2048
  69.       etc...
  70.  
  71.      If you    have UMB.SYS, you may install this driver to allow using 
  72.       the DOS 5    UMB functions and load-high utilities. In this case your 
  73.       CONFIG.SYS file would look something like    this:
  74.     
  75.           dos = high,umb
  76.           device = c:\si\ce.exe          ;configuration editor
  77.           device = c:\si\s-ice.exe /SYM 500    /EXT 2112 /EMM
  78.           device = c:\dos\himem.sys    /m:1
  79.           device = c:\si\umb.sys
  80.           devicehigh = c:\ansi.sys
  81.           devicehigh = c:\dos\smartdrv.sys 2048
  82.       etc...
  83.  
  84.       -------------------------------------------------------------------
  85.       3. PATCH TO SOFT-ICE TO RUN MAGIC    CV WITH    CODEVIEW 3.14
  86.       -------------------------------------------------------------------
  87.      This is a patch to Soft-ICE to    allow MagicCV 3.0 to work with
  88.       CodeView 3.14. Where it says something like "xxxx:wwww+1", if the
  89.       address printed was 2C58:6CBA, use "2C58:6CBB", etc.
  90.      Some users have reported slightly different addresses in earlier
  91.       versions of Soft-ICE (e.g., 6C85 instead of 6CBA).
  92.  
  93.       ren s-ice.exe s-ice.bin
  94.       debug s-ice.bin
  95.       -s cs:0 lffff 42 22
  96.       prints address in    xxxx:wwww format (wwww should be 6CBA)
  97.       -e xxxx:wwww+1 1e
  98.       -s cs:0 lffff 5a 20
  99.       prints address in    xxxx:yyyy format (yyyy should be 6CC5)
  100.       prints address in    xxxx:zzzz format (zzzz should be 6D0B)
  101.       -e xxxx:yyyy+1 1c
  102.       -e xxxx:zzzz+1 1c
  103.       -w
  104.       -q
  105.       ren s-ice.bin s-ice.exe
  106.  
  107.  
  108.      Also, you must    use either the /D or the /E switch with    MCV. 
  109.       Since the    /E switch requires setting up expanded memory, we recom-
  110.       mend trying the /D switch    first.
  111.  
  112.       -------------------------------------------------------------------
  113.       4. BATCH FILES FOR COMPILING WITH    MICROSOFT C COMPILERS
  114.       -------------------------------------------------------------------
  115.       This is a    sample batch file for Microsoft    C 6.0 using a Large 
  116.       memory model, without a floating point coprocessor.
  117.  
  118.        c600\bin\cl /AL /Zi /c %1.c
  119.        c600\bin\link /MA /CO /LI %1,%1,%1,c600\lib\llibce,;
  120.  
  121.       For other    models:change /AL:    change llibce:  if 80x87,    llibc7
  122.           SMALL          /AS         slibce        slibc7
  123.           MEDIUM          /AM         mlibce        mlibc7
  124.           COMPACT          /AC         clibce        clibc7
  125.           HUGE          /AH         hlibce        hlibc7
  126.  
  127.       -------------------------------------------------------------------
  128.       5. BATCH FILES FOR COMPILING WITH    BORLAND    C++ COMPILERS
  129.       -------------------------------------------------------------------
  130.       This is a    sample batch file for Turbo/Borland C++    using a    Large 
  131.       memory model, without a floating point coprocessor. It is    run from 
  132.       the tc\lib directory to avoid having to specify the path for all 
  133.       the library files    called in the tlink command line:
  134.  
  135.        cd tc\lib
  136.        tc\tcc -v -ml -Itc\include -c c:\%1.c
  137.        tc\tlink    /v/s/l/c c0l %1,c:\%1,c:\%1,emu    mathl cl
  138.        cd\
  139.  
  140.       Other models: change -ml:      change c0l:  change mathl:   change cl:
  141.         SMALL       -ms         c0s          maths          cs
  142.         MEDIUM       -mm         c0m          mathm          cm
  143.         COMPACT       -mc         c0c          mathc          cc
  144.         HUGE       -mh         c0h          mathh          ch
  145.       For hardware FP (80x87) use "fp87" in place of "emu".
  146.  
  147.       -------------------------------------------------------------------
  148.       6. BATCH FILE FOR    COMPILING WITH BORLAND TURBO PASCAL
  149.       -------------------------------------------------------------------
  150.  
  151.        The following batch file    format is recommended:
  152.  
  153.          tpc %1    /B/GD/$E+/$F+/$S+/$L+
  154.          msym %1
  155.  
  156.       -------------------------------------------------------------------
  157.       7. CONFIG    EDIT
  158.       -------------------------------------------------------------------
  159.       CONFIG EDIT (CE.EXE) is an on-the-fly editor for CONFIG.SYS. 
  160.       Install CE.EXE as    the 1st    "DEVICE=" in your CONFIG.SYS file.
  161.  
  162.       When your    system boots, you will hear a tone.  You have a    short 
  163.       time to press any    key after the tone (we recommend the SPACE bar). 
  164.       If you press a key CE will take control. CE allows changing 
  165.       CONFIG.SYS before    using it. 
  166.  
  167.       CE.EXE Version 2.0 also lists all    the CONFIGxx.xxx files,    and 
  168.       allows choosing which one    to boot    with. The chosen CONFIGxx.xxx 
  169.       file may be edited permanently or    on a one-time basis before 
  170.       booting. CE.EXE must be the first    driver in all the CONFIGxx.xxx 
  171.       files, because it    cleans up for the previous bootup operation 
  172.       before booting.
  173.  
  174.       MAIN FUNCTIONS WITHIN THE    CE.EXE MENU:
  175.       ESC   - Boot using the current CONFIG.SYS    file.
  176.       ENTER - Boot using the selected file without editing.
  177.       F10   - Boot using the selected file without editing, and    copy it    
  178.           into CONFIG.SYS. The previous CONFIG.SYS is saved    as 
  179.           CONFIG.BAK.
  180.       F2    - Edit the selected    file before booting. To    exit the edit 
  181.           session select ESC, F1 or    F10 (see below).
  182.  
  183.           ESC   - Exit the edit session with no changes.
  184.           F1    - Change the selected file for this    boot only. The 
  185.               changes are not permanant.
  186.           F10   - Change the selected file permanently (including for
  187.               this boot).
  188.  
  189.       OTHER IMPORTANT NOTES:
  190.  
  191.       CE can also be run from the command line.     This is for a quick look
  192.       or quick changes to CONFIG.SYS.
  193.  
  194.       The /Q switch (Quiet) will disable the initial sound made    by CE.EXE
  195.       when it is installed in CONFIG.SYS.
  196.  
  197.       -------------------------------------------------------------------
  198.       8. MSYM WARNINGS
  199.       -------------------------------------------------------------------
  200.      When the compiler does    not produce correct debug information in 
  201.       the .EXE file, the .EXE file must    be made    without    debug infor-
  202.       mation, and a .MAP file with line-number data must be created. MSYM
  203.       must be used to make a .SYM file from the    .MAP file so that Soft-
  204.       ICE can get the symbolic and source information correctly.
  205.  
  206.      MSYM requires a Microsoft-compatible .MAP file    with at    least one
  207.       true Public symbol. It returns the message "Hex Value Expected" if 
  208.       no Public    symbol is found. This is common    with Assembly language 
  209.       programs because public symbols must be declared specifically, 
  210.       while higher language compilers typically    make all procedure names 
  211.       public.
  212.       If all the Public    symbols    in the .MAP file are Absolute, or if some
  213.       modules do not have a Class, an invalid .SYM file    may be produced, 
  214.       which can    cause problems when running Soft-ICE.
  215.  
  216.      MSYM searches for the strings "Start" and "Publics by Value" 
  217.       within the .MAP file, and    will return an error message if    these 
  218.       exact strings are    not found.
  219.  
  220.      The versions of MSYM prior to November    1991 cannot correctly 
  221.       process public names longer than 49 characters. If a longer name is
  222.       encountered, it prints the message "String not found" with no name,
  223.       and then aborts. Zortech C++ and Borland C++ allow function names    
  224.       to include their entire argument list, so    such errors are    likely to
  225.       occur when using these compilers.    Versions of MSYM dated from 
  226.       November 1991 and    later allow public names up to 250 characters 
  227.       long.
  228.  
  229.       -------------------------------------------------------------------
  230.       9. COMPILING WITH    TOPSPEED
  231.       -------------------------------------------------------------------
  232.       The following    is a recommended project file format for com-
  233.       piling with Topspeed (large model):
  234.  
  235.       #system auto exe
  236.       #model large jpi
  237.       #pragma debug(vid=>full)
  238.       #pragma debug(line_num=>on)
  239.       #compile %main
  240.       #link %prjname
  241.  
  242.       This creates a detailed map file. Use    our MSYM.EXE utility to    
  243.       create a .SYM file using the command:
  244.           msym program-name         
  245.       Bounds-Checker will extract the debug information    from this file.
  246.  
  247.       The following    is a recommended batch file format (large model).
  248.       The default redirection file TS.RED must be in your path;    normally 
  249.       this file    is in the same directory as TSC.EXE (typically TS\SYS).
  250.  
  251.       tsc c:\%1.c /m /ml /v2 /debug(line_num=on)
  252.       msym %1
  253.  
  254.       Topspeed does    not generate line-number debug information for 
  255.       the line containing "main". In some cases    this prevents being able 
  256.       to display source    code.
  257.  
  258.       -------------------------------------------------------------------
  259.       10. BPAND    PROBLEM
  260.       -------------------------------------------------------------------
  261.       The BPAND command does not work for BPX type breakpoints. This 
  262.       includes F9 style    point-and-shoot    breakpoints. You must use a hard-
  263.       ware type    of breakpoint such as BPIO or BPM X.
  264.  
  265.       Also,    the order in which the breakpoints are listed in the 
  266.       BPAND command is not significant;    they do    not have to occur in that
  267.       specific order. The break    will occur when    all the    breakpoints 
  268.       listed have occurred at least once.
  269.  
  270.       -------------------------------------------------------------------
  271.